home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / status26.zip / STATUS.DOC < prev    next >
Text File  |  1993-01-13  |  19KB  |  410 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                         Network Mail Status (Postlink Version)
  8.           =================================================================
  9.  
  10.                First  off I  would like  to thank  those users  who offered
  11.           suggestions and  made comments.  Some functions and  displays are
  12.           the direct result of this input.
  13.  
  14.                This program generates a network import mail status bulletin
  15.           showing  each conference, 1000  maximum, and the  total number of
  16.           messages imported for  current date  and total to  date for  each
  17.           conferences, total conferences and the total messages to date for
  18.           the specified network.
  19.  
  20.                Also generates  last  import bulletin  showing  last  import
  21.           information: date, time, total messages import in last import and
  22.           total messages imported to date.
  23.  
  24.                It also generates a network export mail status bulletin with
  25.           the  same format as the  above import bulletin.  Since the export
  26.           routine  contains all  conference names  it is  run first  to get
  27.           those  names so  that  conferences with  zero  imports are  still
  28.           displayed in the import bulletin. I could not find another way to
  29.           get all conference names.
  30.  
  31.                Supports  multiple  networks. This  program  uses Postlink's
  32.           export  / import log(s). Single  log file or  separate Import and
  33.           Export  logs.  It does  a monthly  rollover  of the  LOG(s) using
  34.           PKZIP.EXE.  There is  an eighteen  character limit  on conference
  35.           names, names longer than that are truncated.
  36.  
  37.                Starting with version 2.4 there are major changes in the way
  38.           the program runs. Command line parameters have changed once again
  39.           and options are now  in a nine line configuration  file. Requires
  40.           registration  to  remove   "Unregistered  BBS"  from   bulletins.
  41.           Starting with  2.6 you do  not have to  be in the  directory with
  42.           STATUS.EXE nor  does it have  to be on  your path if you  set the
  43.           environment variable.
  44.  
  45.  
  46.                This archive should contain the following files:
  47.  
  48.                STATUS.EXE............ Actual program
  49.                STATUS.DOC............ This file
  50.                STATUS.CFG............ Sample configuration file     
  51.                STATUS2.CFG........... Sample configuration file
  52.                STATUS3.CFG........... Sample configuration file
  53.                READ.ME............... Update/changes information
  54.                STATUS.BAT............ Sample batch file
  55.                FILE_ID.DIZ........... BBS description file
  56.                SUPPORT.TXT........... Location of Support BBS
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                Syntax is pretty straight forward:
  63.  
  64.                                   STATUS STATUS.CFG
  65.  
  66.                Full path  to STATUS.EXE may  be used if  not in path  or in
  67.           current  directory.  If  you do  use  a  path  statement in  your
  68.           execution  of Status (not in current dir  or in path) you need to
  69.           set the environment variable "SET STATUS=path to STATUS.EXE" (SET
  70.           STATUS=C:\UTILITY\OTHER, etc. no ending slash is needed).
  71.  
  72.                It  is  not  necessary  to  add  a  path  statement  to  the
  73.           configuration file since the program  finds itself. Of course the
  74.           file must be in location of STATUS.EXE. If the configuration file
  75.           is not in  the same location then use the  path statement to it's
  76.           location. 
  77.  
  78.                "STATUS.CFG" and can  have any file name  with the following
  79.           format. Paths  to bulletins or logs are not needed if they are in
  80.           or written to the current directory:
  81.  
  82.                          (1) Unregistered BBS
  83.                          (2) 0000
  84.                          (3) Postlink
  85.                          (4) POST1.LOG
  86.                          (5) C:\BBS\BLT7
  87.                          (6) POST2.LOG
  88.                          (7) C:\BBS\BLT77
  89.                          (8) C:\BBS\BLT777
  90.                          (9) PCB
  91.  
  92.                                      CFG line #1
  93.  
  94.                "Unregistered BBS", system name if registered
  95.  
  96.                                      CFG line #2
  97.  
  98.                "0000", serial number if registered.
  99.  
  100.                                      CFG line #3
  101.  
  102.                "Postlink"  should be the name of the actual network you are
  103.           using,  one word and  case sensitive (Rime,  AccessNet, etc.). 18
  104.           characters max, longer  names are truncated.  Say you are  making
  105.           two different network mail runs with the same software, you would
  106.           use those names here, each in it's own configuration file.
  107.            
  108.                                      CFG line #4
  109.  
  110.                "POST1.LOG" is the optional  path and name of  your Postlink
  111.           Export log.  Lines #4 and  #6 can contain  the same file  name if
  112.           your Export and Import logs are in one file.
  113.  
  114.                                      CFG line #5
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                "C:\BBS\BLT7" is the optional path and name for your  Export
  121.           bulletin.
  122.  
  123.                                      CFG line #6
  124.  
  125.                "POST2.LOG" is the  optional path and name of  your Postlink
  126.           Import log. Lines  #4 and #6  can contain the  same file name  if
  127.           your Export and Import logs are in one file.
  128.  
  129.                                      CFG line #7
  130.  
  131.                "C:\BBS\BLT77" is the optional path and name for your Import
  132.           bulletin.
  133.  
  134.  
  135.                                      CFG line #8
  136.  
  137.                "C:\BBS\BLT777" is the optional path and name  for your Last
  138.           Import bulletin.
  139.  
  140.                                      CFG line #9
  141.  
  142.                Color  and characters used are  as follows and  are setup to
  143.           give the sysop as much  control over the output as  possible. Not
  144.           all users  can read  and handle  IBM extended graphic  characters
  145.           (like sight impaired  users and voice hardware).  Program can use
  146.           either "=/-" or IBM's extended graphic characters  "═/─". Line #9
  147.           should contain one of the following options:
  148.  
  149.                "PCB" use IBM extended  graphic characters and PCBoard's @X0
  150.           colorizing codes.
  151.  
  152.                "PCB0" use no IBM  extended graphic characters and PCBoard's
  153.           @X0 colorizing codes.
  154.  
  155.                "ANSI"   use  colorizing   and  no   IBM  extended   graphic
  156.           characters.
  157.  
  158.                "ANSI2" use colorizing and IBM extended graphic characters.
  159.  
  160.                "ASCII"  use  no  colorizing  and no  IBM  extended  graphic
  161.           characters.
  162.  
  163.                "ASCII2"  use   no  colorizing  and   IBM  extended  graphic
  164.           characters.
  165.  
  166.  
  167.  
  168.  
  169.  
  170.                          PKZIP.EXE used by the Status Program
  171.  
  172.                "PKZIP.EXE" must be somewhere in your path or in the current
  173.           directory. When  the month  changes in the  export/import.log the
  174.           program  archives the  current log  into a  file using  'ML'+ the
  175.           current date  (ML010193.ZIP, etc.). It also  includes the current
  176.           logs (1 or  2) and all  three bulletins. It  creates this in  the
  177.           directory  that contains  the log  file (import  log if  two logs
  178.           used). The program then  rewrites the log using only  the current
  179.           new month's data. This way there is only one month's  log data in
  180.           your Postlink log(s).
  181.  
  182.                The  bulletins  are  added to  the  archive  so that  sysops
  183.           wanting to see totals would have the last ones generated prior to
  184.           the rollover without having to do  so manually. With an editor it
  185.           is possible  to  clip out  the totals  at rollover  and create  a
  186.           yearly bulletin showing the totals for each month, adding them up
  187.           and  showing a yearly grand  total using just  as little as 12-15
  188.           lines.
  189.  
  190.                If you do not want the previous month's log(s) simply delete
  191.           the archive from your hard drive. In your calling  batch file you
  192.           can  add "IF EXIST ML*.ZIP DEL ML*.ZIP" and this will auto-delete
  193.           the  archive. If there  are no imported/exported  messages on the
  194.           day of the rollover then a bulletin reflecting same is generated.
  195.           There must be at least one meg of free disk space for the archive
  196.           to be executed. I have  no idea the possible sizes and  if anyone
  197.           has problems with the archive with one meg as the  minimum please
  198.           let  me know  and I  will  increase the  size of  the free  space
  199.           needed. I have been  unable to trap PKZIP.EXE errors  from within
  200.           my  Turbo Pascal 7.0 programs.  I believe PKZIP  handles then and
  201.           does not pass them along to operating system.
  202.  
  203.  
  204.                                         Errors
  205.  
  206.                Errors  are written to the same directory as STATUS.EXE in a
  207.           file  called STATUS.ERR.  If the  file already  exists additional
  208.           errors  are appended to  the end of  the file. It  may be deleted
  209.           after you  have made note  of any errors.  It's existence it  not
  210.           required by the program.
  211.  
  212.                During  the  start  up   procedures  that  program  displays
  213.           "Searching!" while it is looking  for the directory STATUS.EXE is
  214.           located  in.  Also  "Configuring!"  while it  is  reading  in and
  215.           verifying the configuration file. These are to show the user what
  216.           the  program is  doing should  lockups occur.  I had  problems in
  217.           these area and took some time to isolate them, at least now these
  218.           problem area can be isolated. Normally  these two displays should
  219.           be  very quick and unreadable  depending on the  system speed and
  220.           it's and Status' configuration.
  221.  
  222.                It should be noted that when  you start using Status if your
  223.           Postlink log(s) are not  the current month's logs that  they will
  224.  
  225.  
  226.  
  227.  
  228.  
  229.           not roll over until the month rolls over inside the log. Say your
  230.           log(s) are dated 01-15-93 and you start using Status in 02-93, no
  231.           messages since  01-15-93, the  log will  still show  the messages
  232.           imported up till 01-15-93.  If your log contains  multiple months
  233.           of logs when  it rolls them  over you will  only end up with  the
  234.           previous month's log, the  others will have been over  written by
  235.           the  last one in the archive. Either  that or you can archive the
  236.           log(s) and delete everything  up to the current month  before you
  237.           run Status for the first time.
  238.  
  239.                If  you are making two  or more DIFFERENT  network mail runs
  240.           the  only  thing you  must  do  is  make two  or  more  different
  241.           POSTLINK.CFG files,  one with the name  of the LOG  file for each
  242.           network so that ALL  logs are not put into one file. I would have
  243.           no way of  knowing what messages came from what  network in order
  244.           to separate them. You would then just have a TEMP1.CFG, TEMP2.CFG
  245.           and when you call postlink  you just copy TEMP1.CFG POSTLINK.CFG,
  246.           then on next run you might copy TEMP2.CFG POSTLINK.CFG, etc.
  247.  
  248.                A simple batch file might look like one of these:
  249.  
  250.                     SET STATUS=C:\UTILITY
  251.                     CD \POSTLINK
  252.                     COPY TEMP1.CFG POSTLINK.CFG
  253.                     POSTLINK CALLER.CFG
  254.                     STATUS STATUS.CFG
  255.                     SET STATUS=
  256.  
  257.  
  258.                     SET STATUS=C:\UTILITY
  259.                     CD \POSTLINK
  260.                     Copy TEMP2.CFG POSTLINK.CFG
  261.                     POSTLINK CALLER2.CFG
  262.                     C:\UTILITY\STATUS STATUS2.CFG
  263.                     SET STATUS=
  264.  
  265.                Perhaps you want  to make  a bulletin with  the PCBoard  @X0
  266.           codes  and one using straight  ASCII codes and  yet another using
  267.           ANSI codes. The .CFG  files would contain the bulletin  names and
  268.           the form setting (#9):
  269.  
  270.                STATUS STATUS.CFG
  271.                (.CFG with PCB, uses ANSI codes and IBM extended graphic
  272.                 characters)
  273.  
  274.                STATUS STATUS2.CFG
  275.                (.CFG with ASCII, ASCII and no IBM extended graphic
  276.                 characters)
  277.  
  278.                STATUS STATUS3.CFG
  279.                (.CFG with ANSI, ANSI colors and no IBM extended graphic
  280.                 characters)
  281.  
  282.  
  283.  
  284.  
  285.  
  286.                You just call  STATUS as many times as  needed, with as many
  287.           configuration files  as needed  to generate whatever  formats you
  288.           want. On my 386/33 it  takes less than twenty seconds to  run the
  289.           program on a 6,500 line test log (from three BBS systems).
  290.  
  291.  
  292.                                This and Other Programs
  293.  
  294.                If you don't like the program please write to me and explain
  295.           why. Send me any suggestions you might  have. If they enhance the
  296.           overall program I will try to incorporate part, some, all, in the
  297.           next release.
  298.  
  299.                Current versions (01-13-93)  of James Huckabey door/Postlink
  300.           programs. The doors are Door Patch  3.8 doors and now support the
  301.           following  BBS  drop files:  DOOR.SYS,  PCBOARD.SYS, SFDOORS.DAT,
  302.           CALLINFO.BBS, DORINFO1.DEF, DORINFO2.DEF and CHAIN.TXT. Converter
  303.           needed  for other BBS  software. Current releases  also reflect a
  304.           reduction in  registration fees. Send me a  diskette covering one
  305.           meg, with return postage, and I  will return it with all my doors
  306.           and Postlink software on it/them and as  any of my other software
  307.           programs that might fit in any free space.
  308.  
  309.           BBS Doors:
  310.  
  311.           BK14-400 ZIP  Book Review door
  312.           BR14-300 ZIP  BBS Review door
  313.           CS14-500 ZIP  Community Service door
  314.           DR14-300 ZIP  BBS Door Review door
  315.           GO14-400 ZIP  Gotcha game door (enhanced)
  316.           GTPL-400 ZIP  GT Power List door for GT Power BBS
  317.           MR14-300 ZIP  Music Review door
  318.           MV14-300 ZIP  Movie View door
  319.           PCOVE501 ZIP  Pirate's Cove game door (all new release)
  320.           RR14-400 ZIP  Restaurant Review door
  321.           TRLD-901 ZIP  The Rime List Door (name change from PCRL)
  322.           SW14-600 ZIP  Software Review door
  323.           WR14-300 ZIP  Wine Review door
  324.  
  325.           Postlink:
  326.  
  327.           LT100392 ZIP  Lasttime, Generates bulletin when successful
  328.                         Postlink mail transfer. Supports ASCII, ANSI and
  329.                         PCBoard codes. Freeware! (not a door). Filename is
  330.                         compile date.
  331.           STATUS26 ZIP  Generates Postlink bulletin showing total messages
  332.                         to date for each conference, total conferences,
  333.                         total messages, and monthly rollover. Optional last
  334.                         import mail transfer bulletin. Supports straight
  335.                         ASCII, ANSI and PCBoard colorizing.
  336.  
  337.  
  338.  
  339.  
  340.  
  341.                                      Registration
  342.  
  343.                If you find this program  useful please send BBS information
  344.           and one of the following in U.S. funds only:
  345.  
  346.                Registration only.................................. $10
  347.                (outside U.S. please add $2)
  348.  
  349.                Registration and latest version.................... $12
  350.                (outside U.S. please add $3) Include diskette size.
  351.  
  352.                 The  program  package   represents  many   long  hours   of
  353.           programming, testing, updating  and more  testing as  well as  LD
  354.           telephone  calls  to get  it tested  or  distribute the  beta and
  355.           release copies. Please support my efforts and register your copy.
  356.  
  357.           FROM: 
  358.                   Name: 
  359.                        ---------------------------------------------------
  360.                Address:  
  361.                        ---------------------------------------------------
  362.                   City: 
  363.                        ---------------------------------------------------
  364.            State & Zip: 
  365.                        ---------------------------------------------------
  366.                 HUB ID:                       NODE ID:
  367.                        ----------------------         --------------------
  368.           Phone(voice):                        (data)
  369.                        ---------------------         ---------------------
  370.  
  371.           Diskette type if registration includes current version
  372.                                            (360, 1.2, 720, 1.44) ---------
  373.  
  374.           Your version number. If you have current version any
  375.           version request fee is returned.                       ---------
  376.  
  377.              Please  supply name  of BBS  to be  added to  program. It  may
  378.           include other data up  to sixty characters. Anything longer  than
  379.           that will  be truncated, no exceptions. This is to be on one line
  380.           of  code and must be legible since  the serial number is based on
  381.           exact syntax. I cannot be responsible for unreadable data. Please
  382.           print. Case sensitive!
  383.  
  384.           Example:  "Jim's  Graphic BBS".  In Status  it  comes out  as the
  385.           following in all bulletins generated (example is  no IBM extended
  386.           graphic characters):
  387.  
  388.                ==================(Jim's Graphic BBS)==================
  389.  
  390.  
  391.             -------------------------------------------------------------
  392.  
  393.  
  394.  
  395.  
  396.  
  397.                Your registration  number, and  any diskettes  if requesting
  398.           current version or other software, are be sent by return mail.
  399.  
  400.                     James Huckabey
  401.                     3621-A Fraser Street
  402.                     Bellingham, Washington 98226 U.S.A.
  403.                     (206) 671-2868 (voice) I do have a USR 14.4 DS!
  404.  
  405.                You can also contact me at:
  406.  
  407.                     Corporate Headquarters BBS
  408.                     Sysop: Bob Neal
  409.                     RelayNet (tm): CHQBBS (#1255)
  410.                     (815) 886-3233 / (815) 886-9381 (14400 V32bis)